home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat1 / pmem.z / pmem
Text File  |  1997-04-03  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmeeeemmmm - report per-process memory usage
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmeeeemmmm [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _n_a_m_e_s_p_a_c_e] [----SSSS _n_u_m_s_e_c] [----uuuu _u_s_e_r] [----wwww]
  13.      [----zzzz] [----ZZZZ _t_i_m_e_z_o_n_e]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmeeeemmmm reports per-process memory usage statistics within the Performance
  17.      Co-Pilot framework.  Both virtual size and pro-rated physical memory
  18.      usage are reported.
  19.  
  20.      Unless directed to another host by the ----hhhh option, ppppmmmmeeeemmmm will contact the
  21.      PMCD on the local host to obtain the required information.
  22.      Alternatively, the ----aaaa option may be used to obtain the required
  23.      information from an archive (see ppppmmmmllllooooggggggggeeeerrrr(1)).  If the ----aaaa option is used,
  24.      then the ----SSSS option may be used to specify the temporal position from the
  25.      start of the archive.
  26.  
  27.      The ----uuuu option restricts the report to the specified _u_s_e_r on the target
  28.      host or archive.  Normally the report is truncated at the 80th column.
  29.      This is over-ridden with the ----wwww option.
  30.  
  31.      By default, ppppmmmmeeeemmmm reports the time of day according to the local timezone
  32.      on the system where ppppmmmmeeeemmmm is run.  The ----ZZZZ option changes the timezone to
  33.      _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as described in
  34.      eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local timezone at
  35.      the host that is the source of the performance metrics, as identified via
  36.      either the ----hhhh or ----aaaa options.
  37.  
  38.      Normally ppppmmmmeeeemmmm operates on the default Performance Metrics Namespace
  39.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  40.      loaded from the file _n_a_m_e_s_p_a_c_e.
  41.  
  42. RRRREEEEPPPPOOOORRRRTTTT FFFFOOOORRRRMMMMAAAATTTT
  43.      In the report, all sizes are reported in Kbytes unless shown with an MMMM
  44.      suffix, in which case the size is Mbytes (multiples of 1048576 bytes).
  45.      The virtual memory usage statistics represent the total virtual size of
  46.      each process, irrespective of how many pages are valid (resident).  The
  47.      physical memory statistics indicate real memory usage (only valid pages
  48.      are counted) and are pro-rated on a per-page basis between all processes
  49.      which reference each page.
  50.  
  51.      The columns in the report should be interpreted as follows:
  52.  
  53.      ppppiiiidddd       Process id.
  54.  
  55.      ppppppppiiiidddd      Parent process id.
  56.  
  57.      uuuusssseeeerrrr      User name of process owner.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMEEEEMMMM((((1111))))                                                                PPPPMMMMEEEEMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      vvvvttttxxxxtttt      Total virtual memory used by text (executable code) regions
  75.                mapped by the process.
  76.  
  77.      ppppttttxxxxtttt      Pro-rated physical memory used by text regions.
  78.  
  79.      vvvvddddaaaatttt      Total virtual memory used by all non-executable regions,
  80.                excluding shared memory regions.  This includes initialized
  81.                data, bss and stack but not shared memory regions.
  82.  
  83.      ppppddddaaaatttt      Pro-rated physical memory used by all data regions (data, bss
  84.                and stack but not shared memory regions).
  85.  
  86.      vvvvsssshhhhmmmm      Total virtual memory used by all shared memory regions.
  87.  
  88.      ppppsssshhhhmmmm      Pro-rated physical memory used by shared memory regions.
  89.  
  90.      ccccoooommmmmmmmaaaannnndddd   The command and arguments, truncated so each line in the report
  91.                is at most 80 columns (unless the ----wwww option is given).
  92.  
  93.      The report heading shows the amount of physical memory configured on the
  94.      target host and the amount of free memory, as reported by the operating
  95.      system (see the PCP metric iiiirrrriiiixxxx....mmmmeeeemmmm....ffffrrrreeeeeeeemmmmeeeemmmm).
  96.  
  97.      Only memory used in user space is counted - memory used in kernel tables
  98.      such as that used for pppptttteeees, the pppprrrroooocccc and uuuusssseeeerrrr structures are not counted
  99.      because they are allocated in the kernel's address space.
  100.  
  101.      At the end of the report, a summary is printed indicating the totals for
  102.      each column and the grand totals.  The difference between the total
  103.      physical memory in use by all processes and the total configured physical
  104.      memory will always be more than the free memory reported by the operating
  105.      system because the latter also accounts for memory allocated in the
  106.      kernels address space.
  107.  
  108.      All statistics are accurate to within one 256'th of a page (16 bytes on
  109.      Irix 5.3 systems).
  110.  
  111. FFFFIIIILLLLEEEESSSS
  112.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*         default PMNS specification files
  113.  
  114. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  115.      ppppmmmmccccdddd(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmvvvvaaaallll(1), and
  116.      sssspppprrrroooocccc(2).
  117.  
  118. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  119.      All are generated on standard error and are intended to be self-
  120.      explanatory.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.